home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d6 / phlbl20.arc / PHLBL.DOC < prev    next >
Text File  |  1990-11-07  |  47KB  |  1,316 lines
  1.  
  2.  
  3.                   PHLBL
  4.  
  5.  
  6.  
  7.                   Label/Rotary filecard/Postcard Printer
  8.  
  9.  
  10.  
  11.                   Version  2.0
  12.                   Released 11-04-90
  13.  
  14.  
  15.  
  16.  
  17.                   Herron Software
  18.                   P.O. Box 1288
  19.                   Battle Ground, Washington  USA  98604
  20.  
  21.  
  22.  
  23.  
  24.          COPYRIGHT 1990 Phil Herron.  ALL RIGHTS RESERVED.
  25.  
  26.  
  27.                   DISCLAIMER OF WARRANTY
  28.          __________________________________________
  29.  
  30.  
  31.  
  32.          THIS PRODUCT IS PROVIDED FOR EVALUATION, AS IS
  33.          AND WITHOUT WARRANTY OF ANY KIND.  THE AUTHOR
  34.          MAKES NO EXPRESS OR IMPLIED WARRANTIES,
  35.          INCLUDING BUT NOT LIMITED TO MERCHANTABILITY
  36.          OR FITNESS FOR ANY PURPOSE.  IN NO EVENT SHALL
  37.          THE AUTHOR BE LIABLE FOR LOSS OF PROFIT OR ANY
  38.          OTHER COMMERCIAL DAMAGE ARISING FROM EITHER
  39.          THE USE OF OR THE INABILITY TO USE THIS PRODUCT.
  40.  
  41.  
  42.  
  43.          This product should be thoroughly evaluated
  44.          using backed up or noncritical data and files.
  45.  
  46.  
  47.  
  48.  
  49.   ______________________________________________________________
  50.  
  51.   Evaluation Preface                                     Section
  52.   ______________________________________________________________
  53.  
  54.   Shareware.............................................. 0.1.0
  55.     What it is........................................... 0.1.1
  56.     License Terms........................................ 0.1.2
  57.     Registration......................................... 0.1.3
  58.       Benefits, Forms, Fees, Quantity discounts
  59.  
  60.   Evaluation............................................. 0.2.0
  61.     Evaluation Version................................... 0.2.1
  62.     Evaluation Menu...................................... 0.2.2
  63.     Virus Prevention..................................... 0.2.3
  64.  
  65.  
  66.  
  67.   _____________________________
  68.  
  69.   0.1.0          Shareware
  70.   _____________________________
  71.  
  72.  
  73.  
  74.   0.1.1   The SHAREWARE Concept
  75.   _____________________________
  76.  
  77.   "Shareware" is a software distribution method which enables
  78.   the potential user to obtain software at very low initial
  79.   cost, for evaluation on a trial basis.
  80.  
  81.   You can evaluate the software in your own environment, on your
  82.   own machine, with the programs and data that you normally use.
  83.   You're not required to become a registered user unless the
  84.   software meets your needs.
  85.  
  86.   Another benefit of Shareware is lower pricing.  By minimizing
  87.   the marketing and advertising expenses associated with more
  88.   traditional software distribution methods, Shareware products
  89.   can be priced lower.  You don't pay for what you don't need or
  90.   use.
  91.  
  92.   You are encouraged to share the evaluation version of this
  93.   software with others, so long as you follow the limitations
  94.   set forth in the LICENSE TERMS section below.
  95.  
  96.  
  97.   0.1.2   LICENSE TERMS
  98.   _____________________
  99.  
  100.   This product and its documentation are copyrighted and owned
  101.   solely by the author, who reserves all rights to any benefits
  102.   derived from it.  It is distinctly separate from, and should
  103.   not be confused with, those categories of software known as
  104.   "public domain" or "freeware."
  105.  
  106.   You are granted the right to use the evaluation version of
  107.   this software on a trial basis for a limited amount of time,
  108.   to decide whether to continue using (and therefore whether
  109.   to register) the product.
  110.  
  111.   You can transmit this evaluation version to associates by
  112.   copying on diskette or uploading to electronic bulletin
  113.   board or other online services, so long as the program,
  114.   documentation and any associated files are distributed
  115.   together, and not altered in any way.
  116.  
  117.  
  118.   0.1.3   REGISTRATION
  119.   ____________________
  120.  
  121.   When you send in the registration form and fee, you'll receive
  122.   by return mail a diskette containing the latest REGISTERED
  123.   version of the program and documentation.
  124.  
  125.  
  126.   BENEFITS OF REGISTRATION
  127.  
  128.     The registered version WILL NOT include the Evaluation Menu
  129.     front end, start-up time delay or forms printing sections of
  130.     this version.  Thus it will be more convenient to use, from
  131.     either the DOS prompt or from batch files.  It will also be
  132.     12K-15K bytes smaller, for more efficient disk storage and
  133.     faster loading.
  134.  
  135.     The registered version WILL include any new functions
  136.     or enhancements made to date.
  137.  
  138.     You will receive notification of future updates and
  139.     new products.
  140.  
  141.     You will be able to upgrade to newer versions at a
  142.     reduced cost.
  143.  
  144.  
  145.   REGISTRATION FORM
  146.  
  147.     The registration form and a pre-addressed mailing cover
  148.     can be printed from the "Forms Printing" selection of
  149.     the Evaluation menu, discussed in section 0.2.2 below.
  150.  
  151.  
  152.   FEES
  153.  
  154.     The single-quantity registration fee is displayed on the
  155.     initial Evaluation Menu screen.  Higher quantities are
  156.     discussed below.
  157.  
  158.  
  159.   QUANTITY DISCOUNTS
  160.  
  161.     Each registered copy of this software will be licensed for
  162.     operation at a single location (on a single terminal or
  163.     computer) at any one time.  If you need to run the software
  164.     on more than one terminal or computer at the same time, the
  165.     appropriate number of registrations must be made.
  166.  
  167.     Multiple-quantity registration fees are displayed in the
  168.     "QUANTITY DISCOUNT" section of the Evaluation menu.
  169.  
  170.     You can take advantage of quantity discounts by ordering
  171.     multiple registrations of one program or single
  172.     registrations of several different programs at the same
  173.     time.  You also save on shipping and handling charges
  174.     by registering several products together.
  175.  
  176.  
  177.  
  178.   _____________________________
  179.  
  180.   0.2.0          Evaluation
  181.   _____________________________
  182.  
  183.  
  184.  
  185.   0.2.1   EVALUATION VERSION
  186.   __________________________
  187.  
  188.   This software contains the complete and fully functional version
  189.   of the program, the latest available at the time of this release.
  190.  
  191.   The program itself is identical to the REGISTERED version.
  192.   An Evaluation Menu and forms printing section were added
  193.   to ensure that:
  194.  
  195.     (a)   Registration information and forms will not
  196.           become separated from the program file.
  197.  
  198.     (b)   Users who might be unfamiliar with the process
  199.           of displaying a file's contents on the screen or
  200.           printer will have no difficulty learning about,
  201.           evaluating or registering this product.
  202.  
  203.  
  204.   0.2.2   EVALUATION MENU
  205.   _______________________
  206.  
  207.   The program is invoked from the DOS prompt by typing its name
  208.   and pressing the RETURN or ENTER key.
  209.  
  210.   The initial screen displays the warranty section and some
  211.   information about the program:
  212.  
  213.     Program name,
  214.     Version number,
  215.     Release date,
  216.     Single-quantity registration fee.
  217.  
  218.   It next displays the Shareware Product EVALUATION MENU.
  219.   A single key press will select the following functions
  220.   from the menu:
  221.  
  222.     ESC - EXIT to DOS without evaluating this program
  223.      R  - READ the documentation (THIS file)
  224.      x  - EVALUATE this program
  225.      Q  - QUANTITY Discount information
  226.      F  - FORMS printing menu - registration & mailer
  227.  
  228.   When you press "R" to READ the documentation, this file will
  229.   be shown one screen at a time.  The display pauses whenever the
  230.   screen becomes full, and prompts...
  231.  
  232.           <downArrow> or Esc
  233.  
  234.   The <downArrow> character is similar to the "MORE" prompt in
  235.   other DOS utilities.  It indicates that more is available.
  236.   Press ESCape to exit back to the Evaluation Menu, or any normal
  237.   typing key to continue (space bar is a convenient key to use).
  238.  
  239.  
  240.   0.2.3   VIRUS PREVENTION
  241.   ________________________
  242.  
  243.   If you'd like to evaluate this software but you're not sure
  244.   where it's been, you can order a copy straight from the source.
  245.   See the SHAREWARE PRODUCT CATALOG section at the end of this file.
  246.  
  247.  
  248.  
  249.  
  250.    _________________________________________________________________
  251.  
  252.    Table of Contents                                         Section
  253.    _________________________________________________________________
  254.  
  255.    PhLBL...................................................... 1.0
  256.       Introduction............................................ 1.1
  257.       Explanation............................................. 1.2
  258.       System Requirements..................................... 1.3
  259.          Installing........................................... 1.3.1
  260.       Help.................................................... 1.4
  261.       Syntax.................................................. 1.5
  262.          Wildcard Characters.................................. 1.5.1
  263.       File Selection Window................................... 1.6
  264.       Examples................................................ 1.7
  265.          Operating Screen..................................... 1.7.1
  266.       Data Storage Files...................................... 1.8
  267.  
  268.       Printing................................................ 1.9
  269.          Printer Attributes................................... 1.9.1
  270.          Label Sizes.......................................... 1.9.2
  271.       Settings................................................ 2.3
  272.       Miscellaneous notes..................................... 2.4
  273.       Applications............................................ 2.5
  274.       Error messages.......................................... 2.7
  275.       DOS ErrorLevel.......................................... 2.8
  276.       Future Additions........................................ 2.9
  277.       Version History......................................... 3.0
  278.  
  279.    Support.................................................... 9.0
  280.       Problem Resolution...................................... 9.1
  281.       Before Reporting........................................ 9.2
  282.       Reporting a problem..................................... 9.3
  283.       Custom Modifications.................................... 9.4
  284.       Correspondence.......................................... 9.5
  285.  
  286.    Shareware Product Catalog................................. 10.0
  287.  
  288.  
  289.  
  290.  
  291.          **********************************************
  292.                   NEW in this version
  293.          **********************************************
  294.  
  295.          *  Added label movement commands for rapid navigation
  296.             up, down, and to top or bottom of datafile.
  297.  
  298.          *  Label "Mark"/"Unmark" for subsequent searches.
  299.  
  300.          *  Label search by comment line, first line of label,
  301.             or Marked/Unmarked state.
  302.  
  303.  
  304.  
  305. _________________________________________________________________
  306.  
  307.                PHLBL
  308. 1.0
  309.                Label/Rotary filecard/Postcard Printer
  310. _________________________________________________________________
  311.  
  312.  
  313.  
  314.  
  315.  
  316. 1.1   INTRODUCTION
  317. __________________
  318.  
  319.   Label printers generally seem to come in two forms: too simple
  320.   to be useful, or too complex for occasional use without a
  321.   refresher course.
  322.  
  323.   This program began life as a "quick and easy" label printer.
  324.   It's gained some features along the way, but most of them can
  325.   be ignored if not needed.  When needed, they're summarized in
  326.   several help screens.
  327.  
  328.   PHLBL provides easy locating and printing of your most frequently
  329.   used labels/cards/tags, such as return address labels or rotary file
  330.   cards/postcards for advertising.  If you maintain extensive mailing
  331.   lists or need labels sorted by name or zip code, you may also need a
  332.   dedicated mailing list manager.
  333.  
  334.  
  335.  
  336.  
  337. 1.2   EXPLANATION
  338. _________________
  339.  
  340.    PHLBL manages the loading, finding and printing of labels.
  341.    Maintenance and editing are done using a word processor or text
  342.    editor that you already know, so there won't be any strange new
  343.    word processor commands to learn.
  344.  
  345.    PHLBL allows the use of different printer attributes for each
  346.    line of each label.  Optional line Attribute commands ("@Axxx...",
  347.    discussed later) are stored with the labels in a data file.
  348.  
  349.  
  350.    Any ASCII- (American Standard Code for Information Interchange)
  351.    compatible editor can be used to add or edit labels.  Although most
  352.    editors (even the DOS EDLIN utility) can be used, there are some
  353.    advantages to using one of the Shareware or retail memory-resident
  354.    utility packages.  A few of the available desktop accessory
  355.    programs are:
  356.  
  357.        ALT                 HomeBase
  358.        Desk Commando       My-Desk
  359.        DeskMate            PC DeskTeam
  360.        DeskUtil            Right Hand Man
  361.        EZDesk              SideKick
  362.  
  363.    Using a memory-resident editor, you can edit or enter new labels
  364.    while PHLBL is running, then reload the data file with the Newfile
  365.    command.
  366.  
  367.    With an editor having import capabilities, you can "cut" label text
  368.    from other applications or files and "paste" it into a data file.
  369.  
  370.    Another possibility is a standard text editor with jump (shell)-
  371.    to-DOS capability.  Such an editor can be used to create or edit
  372.    a data file, then you can shell to DOS to run PHLBL.
  373.  
  374.  
  375.  
  376.  
  377. 1.3   SYSTEM REQUIREMENTS
  378. _________________________
  379.  
  380.    PC, XT, AT or compatible.
  381.    DOS version 2.1 or later.
  382.    256K or more RAM recommended.
  383.  
  384.    The maximum number of labels per datafile depends on the amount of
  385.    user memory (RAM) free after DOS, PHLBL and any memory-resident
  386.    utilities are loaded.
  387.  
  388.    PHLBL's registered version (without the evaluation front end) uses
  389.    about 62K for operation, plus another 1310 bytes for each label in
  390.    the datafile.  A 640K system with no memory-resident utilities will
  391.    handle up to about 400 labels per datafile.  If the whole datafile
  392.    won't fit in memory, the user is notified, then normal operations
  393.    resume.
  394.  
  395.    An Epson-compatible dot-matrix printer is needed if printer
  396.    attributes are used; most other printers will work for plain
  397.    labels.
  398.  
  399.    PHLBL was designed using an Epson FX-85 dot-matrix
  400.    printer with this default configuration at power-up:
  401.  
  402.       Default pitch ......... Draft Pica
  403.       Horizontal spacing .... 10 Chars per inch
  404.       Vertical spacing ......  6 Lines per inch
  405.  
  406.  
  407.  
  408.  
  409. 1.3.1   INSTALLING
  410. __________________
  411.  
  412.    The program can be run from diskette or from hard disk.
  413.    No installation is necessary, other than copying the
  414.    files to a drive and directory of your choosing.
  415.  
  416.  
  417.  
  418.  
  419. 1.4   HELP
  420. __________
  421.  
  422.    Can't remember the command line syntax?
  423.    Issue the program's name without any parameters; it will load the
  424.    default label data file PHLBL.LBL, or if not found, will display a
  425.    file selection window containing files and subdirectories available
  426.    from this point.
  427.  
  428.  
  429.  
  430.  
  431. 1.5   SYNTAX
  432. ____________
  433.  
  434.     PHLBL [filespec]
  435.  
  436.       If a filespec is not entered, PHLBL will try to load the default
  437.       data file, PHLBL.LBL, if it exists in the current directory.  If
  438.       not, it will display a file selection window.
  439.  
  440.  
  441.  
  442.  
  443. 1.5.1   WILDCARD CHARACTERS
  444. ___________________________
  445.  
  446.   Wildcard characters * and ? are legal for use in specifying
  447.   filenames and extensions.
  448.  
  449.  
  450.  
  451.  
  452. 1.6   FILE SELECTION WINDOW
  453. ___________________________
  454.  
  455.   A file selection or "pick" window is displayed:
  456.  
  457.     - Whenever the command line argument (the filespec) includes
  458.       wildcard characters;
  459.  
  460.     - Whenever the main menu "NewFile" command prompt is answered by
  461.       pressing the <Return> key with no filespec, or when the filespec
  462.       entered includes wildcard characters.
  463.  
  464.   The window will display a sorted list of files and/or directory
  465.   names (500 maximum) that match the filespec entered.
  466.  
  467.   Selection is made by moving the reverse-video block to the desired
  468.   location, then pressing the <Return> key.
  469.  
  470.   Directory names are displayed in higher intensity than filenames.
  471.   "..\" is the "parent" directory to the current one, so if you're in
  472.   C:\LA and select "..\", you will get a list of files in C:\, the
  473.   root directory.  By selecting directory names, you can get a file
  474.   list from anywhere on the current drive.
  475.  
  476.  
  477.  
  478.  
  479. 1.7   EXAMPLES
  480. ______________
  481.  
  482.   Valid command lines:
  483.  
  484.     PHLBL            - tries to load default file PHLBL.LBL
  485.  
  486.     PHLBL *.*        - file selection window of current dir.
  487.  
  488.     PHLBL A:*.*      - file selection window of A: root dir.
  489.  
  490.     PHLBL C:\LA\*.L* - file selection window of C:\LA, files *.L*
  491.  
  492.     PHLBL MyFile.Txt - tries to load MyFile.Txt; halts if not found.
  493.  
  494.  
  495.   Filespecs shown above are also valid from the main menu "NewFile"
  496.   command prompt.
  497.  
  498.  
  499.  
  500.  
  501. 1.7.1   OPERATING SCREEN
  502. ________________________
  503.  
  504.   The operating screen appears whenever "PHLBL" is issued from the DOS
  505.   prompt with a valid file specification; assuming that PHLBL.EXE and
  506.   default data file PHLBL.LBL are both located in subdirectory \LA,
  507.   and it is the current directory, no command line argument is needed:
  508.  
  509.            PhLbL
  510.  
  511.   loads PHLBL.LBL, and the screen displays:
  512.  
  513.  
  514.    1    __PhLbl_______________________
  515.    2   |______________________________|
  516.    3   Label 1 of 20   File  C:\LA\PHLBL.LBL
  517.    4                   Margin 0   Lines/Skip 15/1   Attr BDDDD
  518.    5   ┌─────────────────────────────────────────────────────────┐
  519.    6   . This is a comment line
  520.    7   ┌─────────────────────────────────────────────────────────┐
  521.    8   Label 1, line 1
  522.    .   Label 1, line 2
  523.    .   ...
  524.    .   └─────────────────────────────────────────────────────────┘
  525.   24
  526.   25   F1-help  _Print _Mark _Find _Newfile _Ruler _Settings _Esc
  527.  
  528.  
  529.   Lines displayed:
  530.     1  - Program name/copyright block
  531.     2  - "
  532.     3  - Label number; Filespec of current data file.
  533.     4  - Marked/Unmarked window: blank if label not marked.
  534.        - Margin setting:
  535.            May be embedded in the data file; can be changed
  536.            from the main menu's Settings submenu.
  537.        - Lines/Skip setting: defaults are 5/1.
  538.            Both can be embedded in data files;
  539.              Lines: height of label or other printing stock.
  540.              Skip:  lines between labels. Usually left at default.
  541.        - Printer Attributes assigned to this label:
  542.            One character for each line in the current label.
  543.            Default is D for Draft; others may be embedded in the
  544.            data file using the "@Axxx..." command.
  545.     5  - Comment border - not displayed if no comment attached.
  546.     6  - one-line comment (if any) attached to current label.
  547.     7  - Label top border; can be switched to a ruler.
  548.     8  - One to fifteen lines display current label contents,
  549.     .    depending on label length and Lines setting (described
  550.     .    above).  Label lines can be any length; however, only the
  551.     .    first 79 characters will be displayed or printed.
  552.     ?
  553.     ?+1  Label bottom border; can be switched to a ruler.
  554.    24  - Message/Prompt window.
  555.    25  - Bottom line on the screen is the main menu:
  556.  
  557.          Key        Function
  558.          --------   -------------------------------------------
  559.          F1         Help screens
  560.  
  561.          /Space   Move to previous/next label
  562.  
  563.          Home/^PgUp Move to first label in file.
  564.          End /^PgDn Move to last label in file.
  565.                     First or last label is indicated by
  566.                     "Label nn of nn" (line 3) in reverse video.
  567.  
  568.          P)rint     submenu:  See section 1.9, "PRINTING"
  569.                               for more information.
  570.                             - P - Print single label
  571.                             - Q - print Quantity of labels
  572.  
  573.          M)ark      Mark/Unmark toggle and auto-advance to next label.
  574.                     Status is displayed on the left side of line 4.
  575.  
  576.          F)ind      submenu:  Text searches are case insensitive.
  577.                               Use <^L> to repeat Last find.
  578.                             - F - Find label text
  579.                             - C - find Comment text
  580.                             - M, U - find Marked, Unmarked labels
  581.  
  582.          N)ewFile   Change to different datafile
  583.  
  584.          R)uler     Ruler on/off (toggle)
  585.  
  586.          S)ettings  submenu - M - set printer left Margin
  587.                             - P - select Printer number (default is Lpt1)
  588.  
  589.          <Esc>      Quit
  590.  
  591.  
  592.  
  593.  
  594. 1.8   Data Storage Files
  595. ________________________
  596.  
  597.   PHLBL works with any number of data storage files on any drive, so
  598.   labels can be grouped in as many files as needed for convenient
  599.   handling.  Labels can be grouped by filename, extension,
  600.   subdirectory, and even by disk drive.
  601.  
  602.   Some examples:
  603.  
  604.     Subdirectory \BIZ-INT      (Business, internal)
  605.     Label files   Inv.LBL      (product inventory labels)
  606.                   DiskLabl     (diskette labels)
  607.                   FileLabl     (file folder labels)
  608.                   RoloLabl     (rotary file cards)
  609.                   Govt.LBL     (taxing authorities)
  610.  
  611.     Subdirectory \BIZ-EXT      (Business, external)
  612.     Label files   Distr.LBL    (distributors of your product)
  613.                   Vendors.LBL  (suppliers to your business)
  614.                   Customer.LBL (customer list)
  615.                   MailList.1   (mailing list 1)
  616.                   MailList.2   (mailing list 2)
  617.  
  618.     Subdirectory \PERSONAL
  619.     Label files   Personal.LBL (personal contacts)
  620.                   Xmas.LBL     (Christmas card list)
  621.                   Tape         (audio, video cassette labels)
  622.  
  623.  
  624.   BASIC LABELS
  625.     Labels are stored in ASCII text files.  The most basic data file,
  626.     containing two labels:
  627.  
  628.       Label One, line 1
  629.  
  630.       Label Two, line 1
  631.  
  632.     At least one blank line must separate a label from its neighbors.
  633.     Any block of text without a blank line is considered one label.
  634.  
  635.  
  636.   COMMENT LINES
  637.     A comment line begins with a period (".") in column 1, and is
  638.     ignored by the label printer.  Any number of comment lines can
  639.     be included in a data file.
  640.  
  641.     Control information can be included on the comment line just above
  642.     the label, where the "Find" function can search for it.  Control
  643.     information could include:
  644.  
  645.         Date entered (for later purging).
  646.         Words or abbreviations for label selection.
  647.  
  648.     Examples:
  649.       . 10-22-90 Customer ID 12345
  650.       . Vendor label 1 of 3
  651.  
  652.  
  653.     Comment lines separated from any label by a blank line are not
  654.     attached to any label, so are never displayed.
  655.  
  656.     Comment lines without a blank line below them are attached to the
  657.     following label; the last comment line above a label is displayed
  658.     on the screen with that label, and its contents can be searched
  659.     using the Find function.
  660.  
  661.       .     This comment block is not attached to a label.
  662.       ..... It can be used for internal notes...
  663.  
  664.       .This comment will be displayed with Label One
  665.       Label One, line 1
  666.  
  667.       . This comment line is NOT displayed on screen
  668.       . This comment line is shown on screen
  669.       Label Two, line 1
  670.  
  671.  
  672.   BLANK LINES within LABELS
  673.     These are any beginning with a dash, "-" in column one, and
  674.     having no other characters.  They force a blank line within
  675.     the label when it is displayed or printed.
  676.  
  677.       Label One, line 1
  678.       -
  679.       Label One, line 3
  680.  
  681.  
  682.   PRINTER ATTRIBUTE LINE
  683.     A printer attribute command line begins with @A in column one,
  684.     and is used to change the default settings of the printer.
  685.  
  686.       Cmd  Attr      CPI       Printer Setup
  687.       ─── ───────── ─────── ────────────────────────
  688.        B   Bold      10      Pica + Emphasized
  689.        C   Compress  17.125  Compressed
  690.        D   Draft     10      Pica (power-on default)
  691.        E   Elite     12      Elite
  692.        H   Huge       5      Expanded + Emphasized
  693.        I   Italic    10      Italic + Emphasized
  694.        N   NLQ       10      Near Letter Quality
  695.        S   Small     20      Compressed + Elite
  696.        U   UnderLin  10      Underlined + Emphasized
  697.        W   Wide       8.5    Expanded + Compressed
  698.  
  699.     An attribute command line for a 5-line label should include five
  700.     letters from the table above (one for each line in the label).
  701.     Lines for which no attributes are given will use the default
  702.     "Draft" attribute.
  703.  
  704.     Case is not significant.  The line can also contain spaces or
  705.     tabs for better readability.
  706.  
  707.       @Aiiiii        Sets all five lines to ITALIC attribute.
  708.       @A I I I I I   Same as above.
  709.  
  710.       @A BcDeH       Sets line 1 to BOLD attribute,
  711.                           line 2 to COMPRESSED,
  712.                           line 3 to DRAFT,
  713.                           line 4 to ELITE,
  714.                           line 5 to HUGE.
  715.  
  716.  
  717.   MARGIN SETTING
  718.     A margin setting line begins with @M in column one, and is used to
  719.     set the left margin to other than the default of zero.  Left
  720.     margins are set in 0.10 inch increments, and can range from 0 to
  721.     255.  Default is zero.  This example sets the left margin to 42
  722.     for all subsequent labels (or until another @M line is
  723.     encountered):
  724.  
  725.       @M42
  726.  
  727.  
  728.   LABEL HEIGHT SETTING
  729.     A label height setting line begins with @L in column one, and
  730.     sets the maximum number of printing lines in a label.  It can
  731.     range from 1 through 15; default is 5 lines.  This example sets
  732.     the number of lines to 12:
  733.  
  734.       @L12
  735.  
  736.  
  737.   INTER-LABEL SKIP
  738.     A skip setting line begins with @S in column one; it sets the
  739.     number of lines to be skipped after each label, and can range
  740.     from 0 through 99; default is 1 line.  A skip setting of 3:
  741.  
  742.       @S3
  743.  
  744.     To maintain correct label registration in the printer, the sum of
  745.     the height and skip settings must equal the number of lines from
  746.     the top of one label to the top of the following label.
  747.  
  748.  
  749.   Embedded DATE & TIME COMMANDS
  750.     An embedded date command !@DATE or time command !@TIME can be
  751.     placed in any column.  These cause the current system date or
  752.     time to be displayed on screen (and printed when the associated
  753.     label is printed).  Example:
  754.  
  755.       Label One, printed on date !@DATE, at time !@time.
  756.  
  757.  
  758.   HELP
  759.     PHLBL's help key, function key F1, displays a complete list of the
  760.     above commands and formats.
  761.  
  762.     Default data file PHLBL.LBL contains examples of many of the above
  763.     commands and settings.
  764.  
  765.  
  766.  
  767.  
  768. 1.9   PRINTING
  769. ______________
  770.  
  771.   Printing selections apply only to the label currently
  772.   displayed on screen.
  773.  
  774.   Press "P" to access the Printing submenu:
  775.  
  776.       P - Print single label
  777.           A shortcut for fast printing of single labels with a double
  778.           press of the "P" key from the main menu.
  779.  
  780.       Q - print Quantity of labels
  781.           Enter number of labels to print, or
  782.           press <Return> to accept default quantity, or
  783.           press <Escape> or <Q> to avoid printing.
  784.  
  785.     Esc - Escape to the prior menu.
  786.  
  787.  
  788.  
  789.  
  790. 1.9.1   PRINTER ATTRIBUTES
  791. __________________________
  792.  
  793.   For plain labels, the attribute commands can be ignored.
  794.   Without them, all labels use "Draft" mode (the default).
  795.  
  796.   If used, printer attributes are stored in the data file, above
  797.   the label where they are to take effect.  The format is
  798.  
  799.     @Axxx...  where up to 15 attributes can be assigned, one for each
  800.               line in the longest label.  Examples can be found in
  801.               PHLBL.LBL.
  802.  
  803.   Each attribute stays in effect until changed, so if all labels in a
  804.   file use the same set of attributes, only one command is needed at
  805.   the top of the file.  Alternately, each label can be given different
  806.   attributes by embedding a new attribute command above each label.
  807.  
  808.   A complete list of attributes and associated pitches is available
  809.   within PHLBL by pressing the F1 help key.
  810.  
  811.  
  812.   KNOWN LIMITATIONS with OLDER PRINTERS
  813.  
  814.     Epson FX-85 (and possibly other models):
  815.       "Elite" mode is not available in IBM mode.
  816.  
  817.     Epson FX-80 and its wide version, the FX-100:
  818.       "Small" mode will not print at 20 characters per inch, since
  819.       these printers don't accept Compressed and Elite attributes at
  820.       the same time.  When sent a line with the attribute of "Small",
  821.       they print in Elite mode. To get the most compact printing, you
  822.       must use the Compressed attribute.
  823.  
  824.       "NLQ" mode prints in draft on these printers, since they don't
  825.       include Near-Letter-Quality capability from the factory.
  826.  
  827.  
  828.  
  829.  
  830. 1.9.2   LABEL SIZES
  831. ___________________
  832.  
  833.   Comments and label lines can be any length; however, only the
  834.   first 79 characters will be displayed or printed.
  835.  
  836.   To print the maximum line length, you'll need to select an attribute
  837.   appropriate for the width of your label or card stock.  In "Draft"
  838.   mode (10 cpi), 79 characters will print 7.9 inches wide; "Small"
  839.   mode (20 cpi) prints the same line in only 3.95 inches.
  840.  
  841.   If a data file does not include the "@Lnn" command to set label
  842.   height, or "@Snn" for lines to skip between labels, defaults are
  843.   used.
  844.  
  845.     Label height in lines       :   max 15, default 5.
  846.     Lines skipped between labels:   max 99, default 1.
  847.  
  848.   The defaults cover common labels with height of 15/16 inch; on a 6
  849.   line per inch printer, they work perfectly with five lines of text
  850.   and one skip line between labels.
  851.  
  852.  
  853.  
  854.  
  855. 2.3   SETTINGS
  856. ______________
  857.  
  858.   Press "S" to access the Settings submenu:
  859.  
  860.       M - set printer left Margin
  861.           Changes the margin from the default value or that set by an
  862.           embedded "@Mxx" command.
  863.  
  864.       P - select Printer number
  865.           Selects printer 1, 2 or 3, if you have more than one printer
  866.           installed.  Default is printer number 1.
  867.  
  868.     Esc - Escape to the prior menu.
  869.  
  870.  
  871.  
  872.  
  873. 2.4   MISCELLANEOUS NOTES
  874. _________________________
  875.  
  876.   PHLBL is most effecient when used in conjunction with a memory-
  877.   resident pop-up notepad utility; the notepad can be used to enter,
  878.   edit, import and view labels.  When labels are setup as required,
  879.   switch back to PHLBL, select "NewFile" from the menu to reload the
  880.   modified data file, then advance to the desired label.
  881.  
  882.  
  883.   To gain familiarity with PHLBL...
  884.     Print the sample labels to see the available printing attributes.
  885.     Experiment with the Left Margin settings to find those useful with
  886.     your labels.  You can conserve label/card stock by printing on
  887.     standard printer paper during experimentation.
  888.  
  889.  
  890.  
  891.   SPECIAL ITEMS in data files are explained in several help screens;
  892.     press function key F1.
  893.  
  894.  
  895.   To stop printing immediately: turn off the printer's power switch.
  896.  
  897.  
  898.   LEFT MARGIN
  899.     If a margin setting is needed for your standard label/card stock,
  900.     you should only have to set it once, with an embedded command near
  901.     the top of each data file.
  902.  
  903.     The menu "M" command can also be used to set the Left Margin to
  904.     another value.  This might be necessary when first setting up
  905.     data files, or when you need to print on nonstandard stock that
  906.     requires a different left margin.
  907.  
  908.     Another time the left margin might be changed manually is when
  909.     you're printing on label sheets that have more than one row of
  910.     labels.  Print the left-most row of labels with the standard
  911.     margin setting, then run the labels through the printer again,
  912.     this time using a greater margin setting to print the second row
  913.     of labels.
  914.  
  915.     A manually-set margin will remain in effect until you exit
  916.     the program or load a new data file.  To keep it permanently,
  917.     it must be entered into the data file.
  918.  
  919.     You generally won't need to have more than one Left Margin or
  920.     Lines/Skip setting in each data file.
  921.  
  922.  
  923.   CREATING a NEW LABEL DATA FILE:
  924.  
  925.     IMPORTING FROM EXISTING APPLICATIONS
  926.       Many programs are capable of exporting data to disk in
  927.       ASCII format.  Once the data is written to a disk file,
  928.       it can be easily edited into the format used by PHLBL.
  929.  
  930.     ENTERING NEW DATA
  931.       Using your text editor, create a new file with an
  932.       appropriate name, then enter the label text (or
  933.       cut and paste from another application).
  934.  
  935.  
  936.   EDITING an EXISTING DATA FILE:
  937.     If you currently have the data file loaded into PHLBL,
  938.     its full filespec will be shown near the top of the
  939.     screen.  Load that file into your text editor.
  940.  
  941.  
  942.   VIEWING NEW labels or CHANGES to existing labels:
  943.     Save the editor file, then either run PHLBL and load that
  944.     file, or if the file is already running in PHLBL, reload
  945.     it by selecting "NewFile" from the main menu.
  946.     Finally, move up or down to the label of interest.
  947.  
  948.  
  949.   DATA FILE LINE LENGTHS
  950.     PHLBL does not check to see if text lines found in data files
  951.     will fit on the output form (labels, rotary file cards,
  952.     etc.). You must determine that by using the ruler (menu "R"
  953.     command) and the CPI (characters per inch) specification of
  954.     the line attributes you're currently using.
  955.  
  956.     EXAMPLE:
  957.       Finding the maximum line length for a particular application...
  958.       Given: CPI for default Draft mode   10
  959.              Label width                   3.5 inches
  960.              Left Margin setting           5
  961.  
  962.       With the printer set for a margin of 0 corresponding to the left
  963.       edge of the label, a margin of 5 shortens the printing area by
  964.       5/10 inch, to 3.0 inches.  3 inches X 10 chars per inch equals
  965.       30 characters that will fit on the remaining label width.
  966.  
  967.  
  968.   Label Height (LINES) SETTING
  969.     Before or immediately following an @L command, an @A command
  970.     should assign attributes for each line.  Otherwise, each
  971.     line will use the default "draft" attribute.
  972.  
  973.  
  974.  
  975.  
  976. 2.5   APPLICATIONS
  977. __________________
  978.  
  979.   Possible output formats:
  980.  
  981.     Rotary file and Rolodex(tm) cards
  982.     Index ("3x5") cards
  983.     Post cards
  984.     Diskette and tape cassette labels
  985.     Inventory labels
  986.     Storage container labels
  987.     File folder labels
  988.     Mailing address labels
  989.     Warning labels
  990.     Library circulation cards, catalog cards, book labels
  991.     Report, binder and notebook cover labels
  992.     Address book entries
  993.     Name tags
  994.  
  995.  
  996.  
  997.  
  998. 2.7   ERROR MESSAGES
  999. ____________________
  1000.  
  1001.   "Out of memory; file only partially loaded - Any key..."
  1002.  
  1003.     Non-fatal; operations will continue, but some of the labels will
  1004.     not be available.  See section 1.3, SYSTEM REQUIREMENTS for
  1005.     details.
  1006.     Not enough memory is available to hold the complete data file.
  1007.  
  1008.     Remedy: either unload some memory-resident utilities to free up
  1009.     some memory, or reduce the size of the data file.
  1010.  
  1011.  
  1012.  
  1013.  
  1014. 2.8   DOS ERRORLEVEL
  1015. ____________________
  1016.  
  1017.   Upon termination, the program returns a DOS ErrorLevel value
  1018.   which indicates how the program ended, and which can be used for
  1019.   subsequent operations in a batch file.  For further information,
  1020.   see the "IF ERRORLEVEL" batch command in your DOS manual.
  1021.  
  1022.    ErrorLevel List:
  1023.  
  1024.       0 - Successful
  1025.       2 - Specified file not found
  1026.       3 - Input parameter is out of range.
  1027.       4 - Input parameter contains an illegal character.
  1028.       5 - Missing parameters.
  1029.      27 - ESCaped out of a file selection window.
  1030.  
  1031.  
  1032.  
  1033.  
  1034. 2.9   FUTURE ADDITIONS
  1035. ______________________
  1036.  
  1037.   Some future enhancements being explored:
  1038.  
  1039.     Alternate (European, ISO) date and time formats for the
  1040.     "!@DATE" and "!@TIME" commands.
  1041.  
  1042.     !@SN     command for Serial/sequence numbering.
  1043.     !@SERIES command for quantity numbering ("nn of nn").
  1044.  
  1045.  
  1046.  
  1047.  
  1048. 3.0   VERSION HISTORY
  1049. _____________________
  1050.  
  1051.   1.0  Initial release.
  1052.   1.1  Added @Lnn command to handle larger labels, index and
  1053.          rotary cards.
  1054.   1.2  Added provision for selecting printer number.
  1055.   1.3  Added a "pick" window for selecting data file.
  1056.   1.4  Added Wide printer attribute (8.5 cpi).
  1057.        Corrections to Printer number selection/assignment.
  1058.   1.5  Margin selection moved from Main menu to Print submenu.
  1059.        Printing quantity selected is now retained during run.
  1060.   2.0  Added new label movement commands, Mark/Unmark function.
  1061.        Added Find function: searches for Marked/Unmarked labels,
  1062.        or text in comment or first line of label.
  1063.  
  1064.  
  1065.  
  1066.  
  1067. _________________________________________________________________
  1068.  
  1069. 9.0            Support
  1070. _________________________________________________________________
  1071.  
  1072.  
  1073.  
  1074.  
  1075. 9.1   PROBLEM RESOLUTION
  1076. ________________________
  1077.  
  1078.   The first user to document and report a problem that we agree
  1079.   needs attention, will receive a free upgrade with the
  1080.   correction when it's been made.  Registered users will get
  1081.   the upgraded registered version; unregistered evaluators
  1082.   will get the upgraded evaluation version.
  1083.  
  1084.  
  1085.  
  1086.  
  1087. 9.2   BEFORE REPORTING
  1088. ______________________
  1089.  
  1090.   Things to try prior to reporting a problem:
  1091.  
  1092.     1 - Reread the documentation to make sure you understand
  1093.         what we thought we understood when we wrote it.
  1094.  
  1095.     2 - If the system reports "Bad command or file name" when
  1096.         you attempt to run the program, its executable file
  1097.         (or at least the file name you specified) was not found.
  1098.  
  1099.         First, make sure no typos or misspellings have crept
  1100.         into your command line; next, try changing your PATH
  1101.         setting, or make the drive & directory where the program
  1102.         resides the "current" drive & directory.
  1103.  
  1104.     3 - If the program is being run from a batch file, try
  1105.         deleting lines previous to the line that actually
  1106.         invokes the program, to see if some prior activity
  1107.         is causing the problem.
  1108.  
  1109.     4 - If you have any memory-resident or "TSR" utilities
  1110.         installed (pop-up calculators/note pads, keyboard
  1111.         enhancements, etc.), try removing them from memory
  1112.         and running the program again to see if the problem
  1113.         reoccurs.
  1114.  
  1115.  
  1116.  
  1117.  
  1118. 9.3   REPORTING A PROBLEM
  1119. _________________________
  1120.  
  1121.   If the problem persists, please document it as completely and
  1122.   accurately as possible; we have to be able to duplicate it
  1123.   before we can begin to resolve it.
  1124.  
  1125.   Include at least the following:
  1126.  
  1127.     1 - Version of DOS you are using.
  1128.     2 - Machine type, drives, memory, etc.
  1129.     3 - Programs executed prior to the problem.
  1130.     4 - Problem program's name and version number.
  1131.     5 - Where and how you obtained the problem program.
  1132.     6 - Address and/or phone number where you can be contacted.
  1133.     7 - Anything you can think of that might relate to the problem;
  1134.         for example, listings of your AUTOEXEC.BAT and CONFIG.SYS
  1135.         files, or any batch files used to run the program.
  1136.     8 - Any relevant printouts.
  1137.  
  1138.  
  1139.   NOTE: Registered users will find the utility UserResp.Exe on
  1140.         the distribution diskette; it can be used to print a
  1141.         pre-addressed mailer and a problem report.
  1142.  
  1143.  
  1144.  
  1145.  
  1146. 9.4   CUSTOM MODIFICATIONS
  1147. __________________________
  1148.  
  1149.   If custom modifications to this software are needed for your
  1150.   particular application, please write to the below address
  1151.   with complete details of your requirements.
  1152.  
  1153.  
  1154.  
  1155.  
  1156. 9.5   CORRESPONDENCE
  1157. ____________________
  1158.  
  1159.   We welcome any comments or suggestions you might have
  1160.   concerning improvements and future enhancements to this
  1161.   product.  Send all correspondence and orders to:
  1162.  
  1163.             Herron Software
  1164.             P.O. Box 1288
  1165.             Battle Ground, Washington  USA  98604
  1166.  
  1167.  
  1168.  
  1169.  
  1170. _________________________________________________________________
  1171.  
  1172. 10.0           Shareware Product Catalog
  1173. _________________________________________________________________
  1174.  
  1175.  
  1176.   This section contains a list of our other Shareware products;
  1177.   it may be updated whenever products are added or changed.
  1178.           ____________________________________________
  1179.  
  1180.   If you'd like to try any of the programs in this catalog,
  1181.   but can't find them locally, you can order evaluation disks
  1182.   straight from the source...
  1183.  
  1184.   Each disk (5.25" DSDD 362K) holds up to five programs and associated
  1185.   documentation files.  Include $4.00 for the first disk, shipping and
  1186.   handling.  Add $2.00 for each additional disk of programs you want
  1187.   to evaluate (Example: $4.00 for 1 to 5 programs, $6.00 for 6-10,
  1188.   $8.00 for 11-15, etc.).  All payments in U.S. funds; Washington
  1189.   State residents must add 7.6% of the total for sales tax.  If
  1190.   your address is outside the U.S. and Canada, include an
  1191.   additional $6.00 for shipping.
  1192.           ____________________________________________
  1193.  
  1194.   Or, you can download them from several online services...
  1195.  
  1196.     GENIE  - in the IBM PC Software Library (menu 616)
  1197.     DELPHI - in the GROUP/PC compat/ DATABASE/GEN area
  1198.  
  1199.     Once in the download areas, search for keyword HERRON.
  1200.           ____________________________________________
  1201.  
  1202.           PROGRAM SPECIFICATIONS AND REGISTRATION FEES
  1203.                    MAY CHANGE WITHOUT NOTICE.
  1204.           ____________________________________________
  1205.  
  1206. 1099 Series - IRS forms preparation
  1207.      1099M  - 1099-MISC  Miscellaneous income statement
  1208.      1099i  - 1099-INT   Interest income statement
  1209.      1099S  - 1099-S     Real Estate Transactions statement
  1210.      1098   - 1098       Mortgage Interest statement
  1211.  
  1212. ChkD - Check_Disk_space reports disk drive space usage.  It reports
  1213.   drive cluster size, then drive space TOTAL, FREE and USED by actual
  1214.   value and by percentage.  Faster and more convenient than the DOS
  1215.   "dir" or "chkdsk" utilities for displaying drive information.
  1216.  
  1217. ChkM - Check_Memory_space reports standard system memory (RAM) space
  1218.   usage.  It reports memory space TOTAL, FREE and USED by actual value
  1219.   and by percentage.  Faster and more convenient than the DOS
  1220.   "chkdsk" utility for displaying system memory information.
  1221.  
  1222. CleanOut - Clean_Out_files searches all directories of the default
  1223.   drive for file(s) specified on command line (wildcards * and ? are
  1224.   legal).  Each time a matching file is found, the user is prompted
  1225.   for disposition: Delete or Save.  File contents, either text or
  1226.   binary, can be VIEWED before deciding.  A single press of the "S"
  1227.   key saves a file; a double press of the "D" key deletes it.  An
  1228.   optional mode allows deletions without confirmation.  Useful for
  1229.   cleaning out .BAK file leftovers, among others.
  1230.  
  1231. CleanZ - Most text editors won't read files beyond the first control-Z
  1232.   end-of-file character.  Control-Z's can become embedded in a text
  1233.   file when several files are combined using the DOS "type" command.
  1234.   CleanZ will strip out each control-Z, or it will optionally replace
  1235.   each with a seldom-used character, to ease the task of locating the
  1236.   former boundaries in combined files.
  1237.  
  1238. DiskInit - Diskette_Initialize erases all files and subdirectories on
  1239.   a 5.25 inch 362k DSDD diskette in about two seconds. It does not
  1240.   initialize marked bad sectors, but tells you to reformat instead.
  1241.  
  1242. ErrLev - ErrLev is a utility for testing batch file "if errorlevel"
  1243.   statements.  During testing, executable program calls are commented
  1244.   out and replaced with "ErrLev nn", where nn is the DOS errorlevel to
  1245.   be simulated.  The simulated errorlevel then exercises branching
  1246.   commands in the batch file under test.
  1247.  
  1248. FindD - Find_Directory searches the default drive for specified
  1249.   subdirectory names, and lists the complete path to those found.
  1250.  
  1251. FindF - Find_File searches the default drive for specified files, and
  1252.   writes the file information to screen or disk.  Useful for locating
  1253.   misplaced files or for generating a listing of all files and
  1254.   subdirectories on the default drive.
  1255.  
  1256. FreqCh - Letter-frequency analysis of text or binary files; handles
  1257.   the full 256-character extended Ascii set; display is sorted in
  1258.   order of Ascii code or frequency of occurrence.
  1259.  
  1260. Gen - Generate_file replaces several trial-and-error methods of
  1261.   building specific-sized files for printer, storage or timing tests.
  1262.   It generates files of any size from zero to twenty million bytes,
  1263.   much faster than typing random characters into a text editor.
  1264.   Besides generating files on disk, it can send characters directly to
  1265.   the console screen, printer or other DOS device.
  1266.  
  1267. Index - Text file INDEX word list utility.  Strips punctuation,
  1268.   digits, whitespace, trivial words and words shorter than a specified
  1269.   minimum, then writes remainder to disk file, one word per line.
  1270.  
  1271. KeyCode - KeyCode responds to each press of a key or combination of
  1272.   keys by displaying the key or combination pressed, its associated
  1273.   Ascii character (if any), key type (normal or extended), Ascii code
  1274.   and Scan code.
  1275.  
  1276. KeySet - KeySet's interactive mode displays the current settings of
  1277.   the CapsLock, NumLock, ScrollLock and PrtSc (Print Screen) keys, and
  1278.   allows them to be changed.  The command line mode directly sets the
  1279.   keys to specified states, allowing use of a batch file for
  1280.   presetting at system boot-up or between applications.
  1281.  
  1282. PhLBL - Ph_Label prints label text stored in easily-maintained ASCII
  1283.   files.  Each label/card/tag can contain embedded commands for date,
  1284.   time, left margin, and selectable printer attribute for each line;
  1285.   5, 8.5, 10, 12, 17 or 20 characters per inch pitch, normal/bold/
  1286.   underlined on Epson compatible dot-matrix printers.
  1287.  
  1288. Qscr - QuickScreen converts a single text screen to an executable file
  1289.   for more rapid display.  The resulting .COM file will write a screen
  1290.   of text much faster than batch file ECHO statements.  Useful for
  1291.   setting up compact menu systems, demos and tutorials.
  1292.  
  1293. Split - Split_file breaks huge text files down into smaller ones that
  1294.   will fit into your text editor or onto a diskette.  Useful for
  1295.   working on large files with a limited filesize memory-resident
  1296.   notepad utility.
  1297.  
  1298. StoRm - STOrage_RooM reports the amount of disk space required for
  1299.   storage of a specified file or group of files on any disk, using any
  1300.   version of DOS.  It takes into account all of the factors involved
  1301.   in determining file storage size.  It locates files specified on the
  1302.   command line and determines their actual total size and the amount
  1303.   of room needed to store them.  Useful for determining the number of
  1304.   files that will fit on a disk.
  1305.  
  1306.           _____________ Future releases ______________
  1307.  
  1308. AcctSort - Fast entry of dollar amounts & assignment to
  1309.   user-designed charts of accounts; user-selected limit
  1310.   checking of $ and account numbers.
  1311.  
  1312.  _______________________________________________________________
  1313. |                                                               |
  1314. |       COPYRIGHT 1990 Phil Herron.  ALL RIGHTS RESERVED        |
  1315. |_______________________________________________________________|
  1316.